(C) 1996 AROS - The Amiga Replacement OS


NAME
#include <proto/iffparse.h>
LONG ParseIFF()
SYNOPSIS
struct IFFHandle * iff
LONG mode

LOCATION
In IFFParseBase at offset 7
FUNCTION
This function is the parser itself. It has three control modes. IFFPARSE_SCAN - the parser will go through the file invoking entry and exit handlers on its way. When it returns it might be for 3 different reasons:

- It invoked a Stop entry/exit handler ( Installed by StopChunk[s] or StopOnExit )

- An error occured. (return value will be negative.)

- The parser reached EOF and returns IFFERR_EOF.

IFFPARSE_STEP - The parser steps through the file, returning to the user each time it enters (returns NULL) and each time it exits (return (IFFERR_EOC) a chunk. It will also invoke entry/exit - handlers.

IFFPARSE_RAWSTEP - same as IFFPARSE_STEP except that in this mode the parse won't invoke any handlers.

INPUTS
iff
pointer to IFFHandle struct.
mode
IFFPARSE_SCAN, IFFPARSE_STEP or IFFPARSE_RAWSTEP.
RESULT
0 if successfull or IFFERR_#?

NOTES

EXAMPLE
BUGS
SEE ALSO
PushChunk(), PopChunk(), EntryHandler(), ExitHandler(), PropChunk[s](), CollectionChunk[s](), StopChunk[s](), StopOnExit()
INTERNALS
HISTORY
13.02.1997 digulla
Bugfix. Loads IFF pictures now.

Added lots of debug output

03.02.1997 digulla
Iffparse.library as supplied by Nils H. Lorentzen